home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / dvs10b4.zip / INST10B4.ZIP / DVS.DOC < prev    next >
Text File  |  1992-01-01  |  21KB  |  513 lines
  1.  
  2.                         For PCBoard 14.5 BBS Systems:
  3.                          Dynamic Verification System
  4.                              v1.0ß2 - 01/01/92
  5.                    (C) 1991 by Damian Clark, Discovery BBS
  6.  
  7.  
  8.                             Sysop Documentation
  9.  
  10.  
  11.  
  12. WARNING!
  13.  
  14.    This is a BETA test program.  This means that this program may not be
  15.  100% reliable.  It is still in it's testing stage.  I have decided to
  16.  distrubute the beta version in order to speed up the release date,
  17.  and make the actual 1.0 release as reliable and stable as possible.
  18.  
  19.    Because DVS is in it's testing stage, new beta versions will be
  20.  released very often.  Please try to keep up to date in order to insure
  21.  safety and functionality to your system as well as to help support
  22.  DVS by reporting NEW problems which need to be fixed.
  23.  
  24.    You can always pick up the latest version of DVS on Discovery BBS...
  25.  The number is listed at the end of this document.  Please report
  26.  any problems you encounter so that they can be fixed as soon as
  27.  possible.
  28.  
  29.  
  30.          Your support of this product is greatly appreciated
  31.  
  32.  
  33.  
  34. Legal:
  35.  
  36.     I, Damian Clark, do not offer any warranties, expressed or implied,
  37.   regarding the use of this program.  By using this program, you agree
  38.   that the terms are on an "AS IS" basis, and I cannot be held responsible
  39.   for ANY damage that may occur by the use of the program.
  40.  
  41.  
  42.     This program is distributed as Shareware, and is not free.  You are
  43.   licensed to use this program for up to thirty (30) days, at which time
  44.   it must be registered or removed from your system.  Please see the
  45.   file REGISTER.FRM included in this archive for information on
  46.   registering.
  47.  
  48. ---------------------------------------------------------------------------
  49.  
  50. Description of program:
  51.  
  52.      The Dynamic Verification System is a PCBoard 14.5 compatible DOOR
  53.    program that will do everything that is needed to get your new users
  54.    verified quick and easily, including callback verification and
  55.    automatic security upgrades conducted by 'scripts', which are totally
  56.    configurable by the SysOp.  External Registration doors may also
  57.    be used with DVS.
  58.  
  59.      This program is completely multi-node compatible, utilizing SHARE
  60.    compatible reads and writes.
  61.  
  62.      DVS has also been tested with DesQview and is completely mutli-tasker
  63.    aware.
  64.  
  65.      DVS has been tested with over 13 different modem types, including
  66.    USRobotics HST/DS, Hayes internal 2400, Cardinal 2400/MNP, and more...
  67.    Chances are that this WILL work with your modem.
  68.  
  69. --------------------------------------------------------------------------
  70.  
  71. Minimum Sytstem Requirements:
  72.  
  73.                  PCBoard v14.5+ Bulletin Board Software
  74.                  180k bytes of free RAM
  75.                  Hard Drive with 1 Megabyte free disk space
  76.  
  77. Multi-Node Additional Requirements:
  78.  
  79.                  SHARE.EXE must be loaded in memory
  80.  
  81.  
  82.  
  83. --------------------------------------------------------------------------
  84. DVS10B2.ZIP
  85.  
  86. INST10B2.ZIP - Main program and text files used by installation program
  87. INSTALL .EXE - Installation program - Run this before use
  88. UPGRADE .EXE - Use to upgrade from previous versions of DVS.
  89. READ    .ME  - Important installtion instructions
  90. CHANGES .NEW - Revision history
  91. FILE_ID .DIZ - Description of file for PCBoard DIR input
  92.  
  93.  
  94. --------------------------------------------------------------------------
  95. INST10B2.ZIP (Unzipped by installation program)
  96.  
  97. VERIFY       - Sample batch file for calling DVS
  98. DVS      DOC - This documentation file
  99. DVS      EXE - The actual executable program
  100. DVS      CFG - Sample configuration file
  101. REG      CFG - Sample Optional Registration Configuration
  102. 714          - For 714 area codes - Local prefixes to SADDLEBACK
  103. 714      NOT - For 714 area codes - Local prefixes to NOT call
  104. NOAREA   NUM - List of areacodes to NOT call
  105. NOPRE    NUM - List of prefixes to NOT call
  106. SYSOP    SCR - Sample Sysop Script File
  107. ADULT    SCR - Sample Adult Script File
  108.  
  109.  
  110.  
  111. <The following are text files displayed to the caller>
  112.  
  113. ALREG        - "You already have verified status" file
  114. DISCON       - "Now disconnecting to call you back" file
  115. INVAL        - "This number cannot be dialed" file
  116. MENU         - Main Menu
  117. NOTNOW       - "This number cannot be called at this particular time" file
  118. PASSED       - "You are now verified" file
  119. PRECALL      - Explains callback verification
  120. PREV         - "This number has already been previously verified" file
  121. VER          - "This is DVS calling for..." file
  122. WELCOME      - The welcome screen
  123. EXREG        - Extern Registration door intro
  124. OPTREG       - Explains optional registration
  125. REGMENU      - Optional Registration Menu
  126. PREG1        - Explains registration form #1 (Sysops in this case)
  127. PREG2        - Explains registration form #2 (Adults)
  128. COMP1        - Showed to caller after completing script 1
  129. COMP2        - Showed to caller after completing script 2
  130. RPASS1       - "You are now verified at visiting sysop status"...
  131. RPASS2       - "You now have access to the adult section"...
  132.  
  133.  
  134.                * Each file has a graphics version with a "G" appended
  135.                  to the filename (i.e. WELCOMEG)
  136.  
  137.               ** You may use files in PCBoard's @X color code format
  138.                  and omit the graphics version (xxxxxxG) if prefered.
  139.  
  140. If you are missing any of these files, please contact Discovery BBS at
  141. the number listed at the end of this document to get the unmodified
  142. archive.
  143.  
  144. -------------------------------------------------------------------------
  145. DVSSETUP.EXE (Setup Program)
  146.  
  147. Use this program to make easy changes to your configuration...  This program
  148. allows menu driven editing of DVS.CFG, REG.CFG, and all of the various
  149. text files which are displayed to the caller.  This program does not
  150. currently allow editing of prefix files, script files, disallowed number
  151. files (NOAREA.NUM, NOPRE.NUM, etc), or script specific text files
  152. (PREG1, COMP2, etc), however future versions of DVSSETUP will include
  153. this.
  154.  
  155.  
  156. -------------------------------------------------------------------------
  157.  
  158. Example of DVS.CFG: (DVSSETUP will automatically edit this for you,
  159.                      or you can manually edit it using this format)
  160.  
  161. INTERRUPT
  162. Discovery BBS
  163. 714
  164. 10
  165. 50
  166. 50
  167. 000000
  168. 00:01
  169. 23:59
  170. 00:01
  171. 23:59
  172. 23:00
  173. 08:00
  174. 00:01
  175. 23:59
  176. 1
  177. 714
  178.  
  179. ************************************************************************
  180. Configuration is as follows:
  181.  
  182. Line 1 : INTERRUPT or BIOS calls
  183. Line 2 : Your BBS Name as you would like it to appear to callers
  184. Line 3 : Your BBS's area code
  185. Line 4 : Highest security level to allow in DVS (New user level)
  186. Line 5 : Security level to give verified users
  187. Line 6 : Expired security level to give to verified users
  188. Line 7 : Expiration date to give verified users in yymmdd format, 000000=none
  189. Line 8 : Local Number Weekday allowed start time
  190. Line 9 : Local Number Weekday allowed end time
  191. Line 10: Local Number Weekend allowed start time
  192. Line 11: Local Number Weekend allowed end time
  193. Line 12: Toll/LD Number Weekday allowed start time
  194. Line 13: Toll/LD Number Weekday allowed end time
  195. Line 14: Toll/LD Number Weekend allowed start time
  196. Line 15: Toll/LD Number Weekend allowed end time
  197. Line 16: Number of area codes LOCAL to your BBS
  198. Line 17: 1st local area code to your BBS
  199. Line 18: 2nd local area code to your BBS
  200. Line 19: etc...
  201.  
  202.  
  203. NOTE:  For all entries containing an expiration date, the actual
  204.        date may be replaced with +xxx, where xxx indicates the number
  205.        of days to 'ADD' to the expiration date from the time of
  206.        verification.  For example, +30 would add 30 days from today
  207.        and make that the expiration date (can be used in REG.CFG also)
  208.  
  209. -----------------------------------------------------------------------
  210.  
  211. Example of REG.CFG (DVSSETUP will automatically edit this for you,
  212.                     however you can creat it manually using this format)
  213.  
  214. 2
  215. Sysop Access
  216. SYSOP.SCR
  217. 70
  218. 70
  219. 000000
  220. Adult Section Access
  221. ADULT.SCR
  222. 55
  223. 55
  224. 000000
  225.  
  226. ********************************************************************
  227. Configuration is as follows:
  228.  
  229. Line 1: Number of active script forms
  230. Line 2: #1 form name
  231. Line 3: #1 form script filename
  232. Line 4: #1 form - security to give after verification
  233. Line 5: #1 form - expired security to give after verification
  234. Line 6: #1 form - expiration date to give after verification
  235. Line 7: #2 form name
  236. Line 8: #2 form script filename
  237. Line 9: etc.....
  238.  
  239.  
  240.  
  241.  
  242. -----------------------------------------------------------------------
  243.  
  244. Calling up DVS from batch file:
  245.  
  246. The format for running DVS.EXE is:
  247.  
  248.                   DVS [CONFIG FILE] [PCBDIR]
  249.  
  250. Where [CONFIG FILE] = The name of your configuration file (i.e. DVS.CFG)
  251. and   [PCBDIR] = The directory where your PCBOARD.SYS file is stored.
  252.  
  253. You may run DVS without the need to be logged into PCBOARD by typing
  254. DVS [CONFIG FILE] LOCAL.
  255.  
  256. MULTINODE SYSTEMS:  The [PCBDIR] parameter must point to the PCBOARD.SYS
  257. file for THAT node.  So you must create separate batch files for each
  258. node which contains the correct PCBOARD.SYS directory.
  259.  
  260. [CONFIG FILE] May be the same for all nodes, as it does not contain any
  261. node-specific information.
  262.  
  263. You may also use PCBoard's new %xxx% variables to use ONE batch file if
  264. prefered.
  265.  
  266. NOTE:  External Registration door support is now available.  Please see
  267. CHANGES.NEW for information concerning this.
  268.  
  269. --------------------------------------------------------------------------
  270.  
  271. Miscellanious data files:
  272.  
  273.    For every configuration, you should modify NOAREA.NUM and NOPRE.NUM
  274.  to reflect which global areacodes and prefixes should NEVER be called.
  275.  
  276.    (Number of area codes FIELD in DVSSETUP)
  277.    On line 15 in DVS.CFG, you should enter the number of area codes which
  278.  are LOCAL to you (no charge if under flat rate).  Most systems only
  279.  have 1 area code (which is the area code of the BBS), however there are
  280.  some which may have more than one.  For those systems, you should enter
  281.  the number of area codes that are LOCAL (line 15), and then list WHICH
  282.  area codes are LOCAL starting on line 16.
  283.  
  284.    (Local area codes)
  285.    A file which is the same name as a local area code listed on line 16+
  286.  should be created.  (i.e. "714").  This file contains a list of all prefixes
  287.  which are LOCAL to your BBS within that area code.  You can always get a
  288.  list of these numbers from your Phone Directory Book issued by your telephone
  289.  company.  If you have more than 1 area code LOCAL to you, you should create
  290.  the other area code files (i.e. "213" and/or "310") which contain a list
  291.  of the local prefixes within that areacode.
  292.  
  293.    Another file named [AREACODE].NOT (i.e. "714.NOT") may be created.  This
  294.  file contains a list of prefixes which cannot be dialed within a local
  295.  area code.  This file is optional and does not need to be created; it
  296.  simply allows a more specific configuration if required.
  297.  
  298.  
  299. --------------------------------------------------------------------------
  300. How DVS works:
  301.  
  302.    When a users first loads DVS, the file WELCOME is displayed to them.
  303.  If they are already verified, the file ALREG will be displayed and
  304.  they will then be returned to PCBoard.  Otherwise,
  305.  after they press enter, MENU is displayed to them.  The choices are as
  306.  follows:  S=Start verification, R=Optional Registration, ?=Help, Q=Quit.
  307.  
  308.    If the user chooses optional registration, a check is made to see if
  309.  this mode is enabled (line 1 in REG.CFG, 0=DISABLED).  If not, they are
  310.  notified as such and returned to the main menu.  Otherwise the file
  311.  OPTREG is displayed, then REGMENU is shown.  If the user chooses form #1,
  312.  for example, the file PREG1 is shown, and they are then asked the questions
  313.  contained in the script file (defined in REG.CFG).  All answers will be
  314.  shown in the caller's log and a file ANSWER.1 will be added to showing
  315.  the questions and the answers the caller entered.  After they finish
  316.  the form, they are asked if they would like to make it official, and if
  317.  so, they will receive the access defined in REG.CFG after callback
  318.  verification is successful.  The file COMP1 would then be displayed
  319.  (assuming it was form#1)
  320.  
  321.  Back to the main menu...
  322.  
  323.    If the user presses Q, they are returned to PCBoard.  If they press ?,
  324.  The file HELP (not created yet) is displayed.
  325.  If they press S, the verification process starts:
  326.  
  327.     The file PRECALL is displayed to the caller.  The caller is then asked
  328.  for his/her area code, prefix, and suffix.  The number they entered is
  329.  displayed to them and they then have the option of (Q)uiting to main menu,
  330.  (R)e-entering the number, or (C)ontinuing verification.  After they
  331.  (C)ontinue, the number they entered will be compared against all numbers
  332.  in the NOAREA.NUM, NOPRE.NUM, and [LOCALAREA]. and [LOCALAREA].NOT files.
  333.  
  334.      If the prefix shows up in the [LOCALAREA] file, a flag is placed as
  335.   "LOCAL".  Otherwise the flag is placed as "NOT LOCAL".
  336.  
  337.      The number then is compared with the start/stop times which are
  338.    contained in the configuration file.  If the LOCAL time is NOT OK
  339.    for a LOCAL number, the file NOTNOW is displayed to the caller.  The
  340.    same is true for a NOT LOCAL number with the time not in the Toll/LD
  341.    parameters listed in the configuration file.  If the number is not
  342.    allowed at that time, after the file NOTNOW is displayed, the user is
  343.    returned to PCBoard.
  344.  
  345.      If the number is in a Local Area Code, the file [LOCALAREA].NOT
  346.    is checked.  If a match is found, the file INVAL is displayed and the
  347.    user is returned to PCBoard.
  348.  
  349.      The number is then processed through the NOAREA.NUM and NOPRE.NUM files.
  350.    if a match is found, again the file INVAL is displayed and the caller is
  351.    returned to PCBoard.
  352.  
  353.    If the number is still marked as "OK TO CALL", the user will then be
  354.  displayed the file DISCON and the modem will drop carrier and call the
  355.  number.  2 attempts are made before the program aborts and reloads PCBoard.
  356.  If a carrier is detected within those 2 attempts, the file VER is then
  357.  displayed to the caller and a prompt for a password is displayed.  The
  358.  user gets 3 chances.  If incorrect, the user is disconnected, the modem
  359.  goes OFF-HOOK, and PCBoard reloads.  If correct, the user is displayed the
  360.  file PASSED and all security upgrades take place.  The number goes into
  361.  the trashcan file (Registered versions only), the caller is
  362.  disconnected, the modem goes OFF-HOOK, and PCBoard reloads.
  363.  
  364.  NOTE:  If the user filled out any optional registration forms, the access
  365.         defined in REG.CFG will be given to them, and the
  366.         associated files (i.e. RPASS.1 for form 1) would be shown to
  367.         them before they are disconnected.
  368.  
  369.  
  370.  
  371.  
  372.  
  373. As you can see, although complicated, you may have any configuration you
  374. desire.  Some samples of configurations are listed below:
  375.  
  376. ----------------------
  377.    You would like all LOCAL callers to be able to be verified at any time.
  378.    You would like any non-local callers to be verified betweek 11pm and 8am
  379.    on weekdays, and any time on weekends.  Your BBS area code is 714,
  380.    and your local area codes are 714.  DVS.CFG would like like this:
  381.  
  382.                 INTERRUPT             (Interrupt output mode)
  383.                 Your BBS Name         (Your BBS Name)
  384.                 714                   (Your BBS area code)
  385.                 10                    (New user level)
  386.                 50                    (Verified sec level)
  387.                 50                    (Verified expired sec level)
  388.                 000000                (Verified expiration date)
  389.                 00:01                 (Local weekday start time)
  390.                 23:59                 (Local weekday stop time)
  391.                 00:01                 (Local weekend start time)
  392.                 23:59                 (Local weekend stop time)
  393.                 23:00                 (Toll weekday start time)
  394.                 08:00                 (Toll weekday stop time)
  395.                 00:01                 (Toll weekend start time)
  396.                 23:59                 (Toll weekend stop time)
  397.                 1                     (Number of local area codes)
  398.                 714                   (Local area code number 1)
  399.  
  400.    Your "714" file would contain a list of prefixes which are LOCAL to
  401.  you (can be found in telephone directory book)
  402.  
  403.  The files NOAREA.NUM and NOPRE.NUM contain a list of areacodes and prefixes
  404. that you don't want dialed (i.e. 1-900 numbers, 976 numbers, etc)
  405.  
  406. ------------
  407.  
  408.           You would like any caller to be verified at any time, local
  409.         or long distance.  Your BBS areacode is 714.  You have 2 local
  410.         area codes which are 714 and 213.  DVS.CFG would look like this:
  411.  
  412.                 INTERRUPT             (Interrupt output mode)
  413.                 Your BBS Name         (Your BBS Name)
  414.                 714                   (Your BBS area code)
  415.                 10                    (New user level)
  416.                 50                    (Verified sec level)
  417.                 50                    (Verified expired sec level)
  418.                 000000                (Verified expiration date)
  419.                 00:01                 (Local weekday start time)
  420.                 23:59                 (Local weekday stop time)
  421.                 00:01                 (Local weekend start time)
  422.                 23:59                 (Local weekend stop time)
  423.                 00:01                 (Toll weekday start time)
  424.                 23:59                 (Toll weekday stop time)
  425.                 00:01                 (Toll weekend start time)
  426.                 23:59                 (Toll weekend stop time)
  427.                 2                     (Number of local area codes)
  428.                 714                   (Local area code number 1)
  429.                 213                   (Local area code number 2)
  430.  
  431.    The files "714" and "213" would contain at LEAST 1 number in each
  432.  file.  This can be ANY number (i.e. your BBS prefix), but a number MUST
  433.  exist.  Although you want ANY number to be dialed, the files must contain
  434.  at least one number so that the number checking procedure works.
  435.  
  436.  The files NOAREA.NUM and NOPRE.NUM contain a list of areacodes and prefixes
  437. that you don't want dialed (i.e. 1-900 numbers, 976 numbers, etc)
  438. -----------------
  439.  
  440.    If you want a SPECIFIC number to be blocked, you can add that number to
  441.  the VERIFIED.NUM file (which contains a list of all previously verified
  442.  files).  The VERIFIED.NUM file is only created after the first time a
  443.  user is successfuly verified, so you may need to create this file if it
  444.  does not yet exist.  The format is as follows:
  445.  
  446.                 USERNAME
  447.                 PHONE NUMBER
  448.                 USERNAME
  449.                 PHONE NUMBER
  450.                 USERNAME
  451.                 PHONE NUMBER
  452.                 ETC...
  453.  
  454.   So say that you don't want the number 714-555-5555 dialed, you would add
  455. an entry into the VERIFIED.NUM file like this
  456.  
  457.                 ANY NAME
  458.                 714-555-5555
  459.  
  460. When a user tries to use that number, the file ALREG will be displayed to
  461. them and they will be returned to PCBoard.
  462. ---------------
  463.  
  464.    Any user logged on locally will enable 'Local Mode' when in DVS...
  465.  This is usefull for checking to see if your configuration is working
  466.  right...
  467.  
  468.  
  469. -------------------------------------------------------------------------
  470.  
  471. Registering DVS:
  472.  
  473.    DVS is not 'crippled' in any way other than the trash can file
  474.  maintanance being disabled in the non-registered version.  Obviously
  475.  if you intend to run DVS for an extended period of time, registration
  476.  is benificial, AND required.
  477.  
  478.  
  479.    You can register your copy of DVS several ways...  The first is to
  480.  print out the file REGISTER.FRM, fill it out, and send it in with your
  481.  $15 check.  The second is to call Discovery BBS and order online with
  482.  your credit card (a registered version will then be made available to
  483.  download within 24 hours).  Visa, and Mastercard are accepted.
  484.  
  485.  
  486. NOW AVAILABLE TO REGISTERED USERS:
  487.  
  488.   Registered users may now run a compilation door to get they're personalized
  489.  DVS.EXE file while online.  Registered users may type COMPILE at the main
  490.  menu to do this.
  491.  
  492. -------------------------------------------------------------------------
  493.  
  494. Bug reports, suggestions, etc...
  495.  
  496.    If you encounter a problem with DVS (bug?), need help with a specific
  497.  configuration, or have a suggestion, you can call Discovery BBS and
  498.  leave me a message.  I can also be reached through the U'NI-Net conference
  499.  DOOR-UTIL.
  500.  
  501.  Damian Clark
  502.  Discovery BBS - Mission Viejo, California
  503.  Node 1 - (714) 457-0460 - USRobotics HST/v42bis - 9600+bps
  504.  Node 2 - (714) 457-0359 - USRobotics HST - 2400 - 9600 bps
  505.  Node 3 - (714) 457-9624 - Cardinal 2400/MNP 300 - 2400 bps
  506.  
  507.  
  508. Thanks for supporting DVS!
  509. ------------------------------------------------------------------------
  510.  
  511. (Note: This document is being re-written at this time - This is a temporary)
  512. (      document only...                                                    )
  513.